home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbbsdocs.zip / RBBSDOCS.APK < prev    next >
Text File  |  1990-11-05  |  6KB  |  110 lines
  1.  
  2.  
  3.  
  4.     APPENDIX K -- RBBS-PC in a MultiLink Environment                        K-1
  5.  
  6.  
  7.     APPENDIX K -- RBBS-PC in a MultiLink Environment
  8.     ------------------------------------------------
  9.     RBBS-PC only runs under Multilink versions 4.0, 3.02 and earlier.
  10.  
  11.     CONFIG's allows  the SysOp  to tell RBBS-PC  that it will  be running  in a
  12.     MultiLink environment.    This  is  ESSENTIAL when  running  RBBS-PC  under
  13.     MultiLink.  CONFIG allows the SysOp to specify what MultiLink terminal type
  14.     code to pass to MultiLink whenever RBBS-PC exits to  DOS via a "Door".  The
  15.     MultiLink  documentation specifies the various terminal type codes.  When a
  16.     SysOp  indicates that "doors" are  available (via parameter  101 of CONFIG)
  17.     and RBBS-PC is to be run under  MultiLink, the SysOp is asked to select the
  18.     MultiLink terminal type that RBBS-PC is to inform MultiLink  to expect when
  19.     MultiLink is given control of the "Door."
  20.  
  21.     RBBS-PC has  been tested running  two copies of  RBBS-PC under DOS  3.2 and
  22.     MultiLink Advanced (versions 3.02 and 4.0) on an IBM PC which had a mother-
  23.     board  containing 256K  and an AST  Comboplus board  with 384K  (a total of
  24.     640K).  However,  to do this RBBS-PC must be  re-compiled (see Appendix U).
  25.     The "autoexec"  file  was named  AUTOEXEC.BAT and  contained the  following
  26.     parameters
  27.  
  28.                         MLINK /9,266/9,266
  29.  
  30.     NOTE!  ==>RBBS-PC must be recompiled with  C:512 in order to  run in a 268K
  31.     partition  under  MultiLink.   As released,  RBBS-PC  is compiled  with the
  32.     parameter C:4096 which requires  a MultiLink partition of 270K.  Of course,
  33.     to SHELL to the external protocols, the partitions must be about 440K.
  34.  
  35.     It is important  to avoid doing  several things when running  RBBS-PC under
  36.     MultiLink.   First, NEVER RUN MLSLICE!   This is because  MLSLICE hangs off
  37.     the PC's timer chain and the code generated by the BASIC compilers violates
  38.     all sorts  of DOS  conventions whenever  it is  utilizing the  PC's speaker
  39.     (i.e. as when RBBS-PC pages the SysOp).  In so doing, the code generated by
  40.     the  BASIC compilers  is  incompatible with  programs  that do  follow  DOS
  41.     conventions.
  42.  
  43.     Second, NEVER use the DOS "PRINT" command!  This is because there is  a bug
  44.     in the  code generated by the BASIC compiler that causes the system to hang
  45.     if a compiled BASIC program is running and DOS is printing something.  This
  46.     bug has  been corrected in  the BASIC  compiler that was  used to  generate
  47.     RBBS-PC.EXE that is distributed.   However the version of  RBBS-PC that you
  48.     get (if other than from CPCUG) may not have this bug corrected.  This  is a
  49.     bug that occurs independent of running MultiLink.
  50.  
  51.     Third, check your Intel 8088 chip's  copyright date by opening up the cover
  52.     and locating the  8088 chip. If the  copyright date printed on the  chip is
  53.     1978 (i.e. pre 1981), REPLACE THE INTEL 8088 CHIP!!!!!  The 1978 Intel 8088
  54.     chip  had several  design flaws  that  will cause  your system  to lock  up
  55.     occasionally.  One of these design  flaws allowed interrupts to occur while
  56.     stack  switching (something  that will  happen running  multiple partitions
  57.     doing disk I/O under any multi-tasking DOS add-on such as MultiLink or even
  58.     IBM's TopView).   Don't blame MultiLink for the flawed Intel 8088 chip that
  59.     IBM put  in your  PC!  It  costs about $70  ($35 for  the chip and  $35 for
  60.     labor)  and  takes about  15  minutes  to have  the  1978  Intel 8088  chip
  61.     replaced.   In fact, if you are going to replace your 1978 Intel 8088 chip,
  62.     you might consider the newer (and 5% to 10% faster) NEC V20 chip.
  63.  
  64.     Fourth, DON'T USE  "BUFFERS=" in the  CONFIG.SYS for DOS!   This may be  an
  65.     "old  wives tale,"  but I  am convinced  (but can't  prove) that  there are
  66.  
  67.  
  68.  
  69.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                     K-2
  70.  
  71.  
  72.     incompatibilities between the code the BASIC compiler  generates, DOS's use
  73.     of "BUFFERS=", and MultiLink.
  74.  
  75.     fifth, RBBS-PC will only run in Background 1 or Background 2.
  76.  
  77.     Finally,  DON'T RUN  PROGRAMS THAT  USE THE  BASIC "RUN-TIME"  LIBRARY, and
  78.     always invoke  the BASIC interpreter with the  command BASIC /C:0! Both the
  79.     BASIC interpreter's handling of communications ports and BASRUN.EXE seem to
  80.     violate enough DOS conventions to "lock up" MultiLink.
  81.  
  82.     When  RBBS-PC is  told that it  is running  in a  MultiLink environment via
  83.     CONFIG parameter 162, RBBS-PC will automatically do the following:
  84.  
  85.       1) When  re-cycling,  it  will   automatically  enqueue  on  the  correct
  86.          MultiLink resource  ID for the  communications port defined  in CONFIG
  87.          for that copy of RBBS-PC to use.
  88.       2) When re-cycling, it will  automatically tell MultiLink that this  is a
  89.          type "9" partition (i.e. MultiLink is NOT to handle the communications
  90.          port).
  91.       3) When exiting to  DOS via a "door",  RBBS-PC will automatically
  92.          tell MultiLink to start  handling the communications  for this
  93.          partition (COM1 or COM2)  and what type of terminal was defined
  94.          in CONFIG that would  be on the communications port  (MultiLink
  95.          terminal types 1 through 12).
  96.  
  97.     Manually, it  is possible  to bring up  and run one  copy of  RBBS-PC under
  98.     MultiLink.  The only  way that I have been  able to bring up two  copies of
  99.     RBBS-PC  successfully (one copy  running in each of  two partitions) was to
  100.     bring them up  via AUTOEXE1.BAT and  AUTOEXE2.BAT files.   It appears  that
  101.     during the  MultiLink initialization sequence when the partitions are being
  102.     established and the  "AUTOEXEx.BAT" files are being  invoked that MultiLink
  103.     doesn't get "confused" and lock up with a second copy of  RBBS-PC present.
  104.  
  105.     If using  Multi-Link to   run multiple  nodes in   the same  machine  under
  106.     DOS 3.x or above, it is recommended that the SysOp  execute SHARE.COM prior
  107.     to starting multiple RBBS-PC nodes under Multi-Link and specify FILES=20 in
  108.     the CONFIG.SYS file.
  109.  
  110.